Skip to content

Conversation

@bmuenzenmeyer
Copy link

@bmuenzenmeyer bmuenzenmeyer commented Jan 14, 2026

Description

Documents docker image flow. I elected not to use mermaid as I thought it was a bit too limiting.

image

Motivation and Context

I get asked this question often. With the most recent security release, I was asked three times within my company how this works.

I talked to @nschonni within #2339 to get some initial alignment.

Testing Details

Example Output(if appropriate)

Types of changes

  • Documentation
  • Version change (Update, remove or add more Node.js versions)
  • Variant change (Update, remove or add more variants, or versions of variants)
  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Other (none of the above)

Checklist

  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING.md document.
  • All new and existing tests passed.

Co-authored-by: Diesmon <torsten.vonbueltzingsloewen@neuland-bfi.de>
@ovflowd
Copy link
Member

ovflowd commented Jan 22, 2026

@bmuenzenmeyer any updates here? Do you need support from my side?

@bmuenzenmeyer
Copy link
Author

I think a code owner here needs to merge it if it's of value. Then I'd find a place on the website to link it too.

Copy link
Member

@sxa sxa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It may be worth having this in a separate file in the docs folder and linking to it from here. This is definitely valuable information. Noting that there is work to decouple of the Alpine releases at the moment so some of this will need to be updated soon too.

It's also worth noting that there are non-x64 Alpine images which we push up which are not depedendent on the unofficial-builds. These are arguably one tier lower than even the unofficial builds in terms of how they are supported, but they would not have an explicit dependency on the unofficial-builds being completed.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR documents the automated Docker image creation and publishing flow for the nodejs/docker-node repository. The PR adds a new "Image Creation Automation" section to the CONTRIBUTING.md file that explains how the project automatically detects new Node.js releases and publishes them to Docker Hub. Additionally, it fixes a spelling error in update.sh.

Changes:

  • Fixed spelling error: "architecure" → "architecture" in update.sh
  • Added new "Image Creation Automation" section to CONTRIBUTING.md documenting the automated workflow for detecting, building, and publishing Docker images

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
update.sh Corrected spelling of "architecture" in a comment
CONTRIBUTING.md Added new section documenting the automated image creation workflow with links to relevant workflows and scripts

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

### Image Creation Automation

- Every 15 minutes, the [workflow](https://github.com/nodejs/docker-node/blob/main/.github/workflows/automatic-updates.yml) within the [nodejs/docker-node](https://github.com/nodejs/docker-node) repo [checks](https://github.com/nodejs/docker-node/blob/main/build-automation.mjs) for new versions of Node.js [published to the website's `index.json` file](https://nodejs.org/download/release/index.json).
- If found, it also checks for an [unofficial musl/Alpline build](https://unofficial-builds.nodejs.org/download/release/index.json).
Copy link

Copilot AI Jan 31, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "Alpline" should be "Alpine".

Suggested change
- If found, it also checks for an [unofficial musl/Alpline build](https://unofficial-builds.nodejs.org/download/release/index.json).
- If found, it also checks for an [unofficial musl/Alpine build](https://unofficial-builds.nodejs.org/download/release/index.json).

Copilot uses AI. Check for mistakes.
- Every 15 minutes, the [workflow](https://github.com/nodejs/docker-node/blob/main/.github/workflows/automatic-updates.yml) within the [nodejs/docker-node](https://github.com/nodejs/docker-node) repo [checks](https://github.com/nodejs/docker-node/blob/main/build-automation.mjs) for new versions of Node.js [published to the website's `index.json` file](https://nodejs.org/download/release/index.json).
- If found, it also checks for an [unofficial musl/Alpline build](https://unofficial-builds.nodejs.org/download/release/index.json).
- If found, the [update script](https://github.com/nodejs/docker-node/blob/main/update.sh) runs
- The workflow opens a pull request either automatically via [nodejs-github-bot](https://github.com/nodejs-github-bot) or in some cases manually, such as when there is a new major releases.
Copy link

Copilot AI Jan 31, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Grammar error: "major releases" should be "major release" (singular) to match "there is a new".

Suggested change
- The workflow opens a pull request either automatically via [nodejs-github-bot](https://github.com/nodejs-github-bot) or in some cases manually, such as when there is a new major releases.
- The workflow opens a pull request either automatically via [nodejs-github-bot](https://github.com/nodejs-github-bot) or in some cases manually, such as when there is a new major release.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants